/**
 * <h3>CooperateController</h3>
 * <p> 文创合作信息管理控制器类 </p>
 *
 * <h3>功能描述</h3>
 * <p> 提供文创合作信息的增删改查等基础操作接口，统一返回AjaxResult格式结果 </p>
 * <p> 所有接口均基于RESTful风格设计，配合SpringMVC与Swagger注解实现标准化API输出 </p>
 *
 * <h3>元数据</h3>
 * <ul>
 *     <li> 作者：郭强 </li>
 *     <li> 创建日期：2025年05月18日 14:20:15 </li>
 * </ul>
 *
 * <h3>其他信息</h3>
 * <ul>
 *     <li> 参考链接：<a href="https://fantastic-admin.hurui.me/guide/permission.html">权限控制文档</a></li>
 *     <li> 示例代码：{@code new CooperateController(cooperationService)} </li>
 * </ul>
 *
 * @apiNote 接口需结合前端权限配置使用，确保安全性；当前部分接口已启用权限注解（如 @PreAuthorize）
 * @implSpec 继承自 {@link BaseController}，复用分页、返回封装等通用逻辑
 * @since v1.0.0.0
 */
package com.dnndo.web.controller.system;

import com.dnndo.common.annotation.Log;
import com.dnndo.common.core.controller.BaseController;
import com.dnndo.common.core.domain.AjaxResult;
import com.dnndo.common.core.domain.PageResult;
import com.dnndo.common.core.domain.R;
import com.dnndo.common.enums.BusinessType;
import com.dnndo.common.utils.bean.BeanDtoVoUtil;
import com.dnndo.system.domain.Cooperation;
import com.dnndo.system.domain.dto.CooperationDTO;
import com.dnndo.system.domain.vo.CooperationVO;
import com.dnndo.system.service.ICooperationService;
import com.github.pagehelper.PageInfo;
import io.swagger.annotations.ApiParam;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.security.access.prepost.PreAuthorize;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;

import java.util.List;

/**
 * 文创合作信息管理控制器类
 */
@RestController
@RequestMapping("/system/cooperation")
public class CooperateController extends BaseController {

    private final ICooperationService cooperationService;

    @Autowired
    public CooperateController(ICooperationService cooperationService) {
        this.cooperationService = cooperationService;
    }

    /**
     * 查询文创合作列表（分页）
     *
     * @param dto 文创合作查询条件封装对象
     * @return PageResult<Cooperation> 分页后的文创合作信息列表及总记录数
     */
    @PreAuthorize("@ss.hasPermi('cooperate:list')")
    @GetMapping("/list")
    public PageResult<CooperationVO> list(CooperationDTO dto) {
        startPage();
        List<Cooperation> list = cooperationService.selectCooperationList(dto);
        return PageResult.pageOk(BeanDtoVoUtil.listVo(list, CooperationVO.class), new PageInfo<>(list).getTotal());
    }

    /**
     * 根据文创合作ID获取详细信息
     *
     * @param cooperateId 文创合作唯一标识符
     * @return R<Cooperation> 包含文创合作详细信息的响应结果
     */
    @GetMapping("/getInfo")
    public AjaxResult getInfo(@ApiParam(value = "文创合作ID", required = true) Long cooperateId) {
        CooperationDTO cooperate = cooperationService.selectCooperationById(cooperateId);
        return AjaxResult.success(R.ok(BeanDtoVoUtil.convert(cooperate, CooperationVO.class)));
    }

    /**
     * 新增文创合作信息
     *
     * @param dto 前端传入的文创合作数据传输对象，包含新增字段
     * @return AjaxResult 操作结果返回对象，包含成功或失败状态
     */
    @Log(title = "文创合作管理", businessType = BusinessType.INSERT)
    @PostMapping("/add")
    public AjaxResult add(@Validated @RequestBody CooperationDTO dto) {
        dto.setUserId(getUserId().intValue());
        return toAjax(cooperationService.insertCooperation(dto));
    }

    /**
     * 修改已有文创合作信息
     *
     * @param dto 前端传入的文创合作数据传输对象，包含更新字段
     * @return AjaxResult 操作结果返回对象，包含成功或失败状态
     */
    @Log(title = "文创合作管理", businessType = BusinessType.UPDATE)
    @PostMapping("/edit")
    public AjaxResult edit(@Validated @RequestBody CooperationDTO dto) {
        return toAjax(cooperationService.updateCooperationById(dto));
    }

    /**
     * 删除指定ID的文创合作信息
     *
     * @param cooperateId 要删除的文创合作唯一标识符
     * @return AjaxResult 操作结果返回对象，包含成功或失败状态
     */
    @Log(title = "文创合作管理", businessType = BusinessType.DELETE)
    @GetMapping("/del")
    public AjaxResult del(@ApiParam(value = "文创合作ID", required = true) Integer cooperateId) {
        return toAjax(cooperationService.deleteCooperationById(cooperateId));
    }
}
